Skip to content

docs(oss-harden): update Code Quality for general availability - #85

Merged
svyatov merged 1 commit into
mainfrom
docs/code-quality-general-availability
Aug 11, 2026
Merged

docs(oss-harden): update Code Quality for general availability#85
svyatov merged 1 commit into
mainfrom
docs/code-quality-general-availability

Conversation

@svyatov

@svyatov svyatov commented Aug 11, 2026

Copy link
Copy Markdown
Owner

What changed

  • skills/oss-harden/references/github.md states the availability filter for GitHub Code Quality first: organization-owned repositories on GitHub Team or GitHub Enterprise Cloud, not GitHub Enterprise Server, and never a user-owned repository. The paragraph said only that the product must be turned on per repository or organization, which reads as a switch every reader has.
  • The same paragraph prices the product at its general availability rate, 10 US dollars per active committer per month plus metered AI usage and Actions minutes. That cost was deferred during the public preview and started on 2026-07-20.
  • The prohibition on adding the code_quality ruleset rule where the product is off becomes a readback: gh api repos/{owner}/{repo}/code-quality/setup answers state of configured or not-configured, or 404 for a repository the plan or the ownership excludes. Add the rule only on configured.
  • AGENTS.md records why this repository's 404 cannot resolve. svyatov/oss-kit is user-owned, so the general availability announcement does not change it, and nothing short of moving to an organization on one of those plans warrants restoring the rule.

Why this way

The availability limit is the cheapest check a reader can apply, so it goes before the cost and the JSON. Somebody reading the old paragraph on a personal repository would price the product and write the rule before finding out that neither applies.

No rule in STANDARD.md changes. R-SEC-09 asks for static analysis on pull requests and CodeQL with the code_scanning rule satisfies it. Code Quality is a paid maintainability product most audited repositories cannot buy, so a rule requiring it would fail every solo and Free-plan project by construction.

Verification

gh api repos/svyatov/oss-kit/code-quality/setup answers 404 Code quality is not available for this repository, and gh api repos/svyatov/oss-kit --jq .owner.type answers User, both on 2026-08-11. The code_quality rule is still absent from the rulesets REST schema, which lists code_scanning, copilot_code_review, and license_compliance_scanning. The setup response fields come from the code quality REST reference.

Affects

Rule or skill Change
oss-harden Code Quality guidance corrected for general availability
R-SEC-09 unchanged

The Code Quality paragraph was written during the public preview. It says the
product must be turned on per repository or organization, which reads as a
switch every reader has. Code Quality reaches organization-owned repositories
on GitHub Team or GitHub Enterprise Cloud only, so a user-owned repository
cannot enable it at all, and that filter settles most cases before cost or
syntax matters. Its cost also stopped being deferred on 2026-07-20.

GitHub now documents the code quality REST endpoints, so the prohibition on
adding the rule where the product is off becomes a command a reader can run.
`GET /repos/{owner}/{repo}/code-quality/setup` answers `configured`,
`not-configured`, or 404 for a repository the plan excludes.

The rulesets REST schema still documents `code_scanning` and no code quality
rule, so that caution stands as written.
@svyatov
svyatov merged commit b7d7424 into main Aug 11, 2026
12 checks passed
@svyatov
svyatov deleted the docs/code-quality-general-availability branch August 11, 2026 17:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant